/*
 * Copyright (c) 2006, 2022, webrx.cn All rights reserved.
 *
 */
package org.beiyou;

/**
 * <p>Project: javase202202 - ArithUntil
 * <p>Powered by Lisi On 2022-05-30 14:38:07
 * <p>Created by IntelliJ IDEA
 *

 * @version 1.0
 * @since 17
 */

import java.math.BigDecimal;

/**
 * 由于Java的简单类型不能够精确的对浮点数进行运算，
 * 这个工具类提供精确的浮点数运算，包括加减乘除和四舍五入。
 */
public class ArithUntil{ //默认除法运算精度
    private static final int DEF_DIV_SCALE = 10;   //默认小数位最大为10
    private ArithUntil(){//这个类不能实例化
    }
    /**
     * 提供精确的加法运算。
     * @param v1 被加数
     * @param v2 加数
     * @return 两个参数的和
     */
    public static Double add(double v1,double v2){

        return add(v1,v2,DEF_DIV_SCALE);
    }
    /**
     * 提供精确的加法运算。
     * @param v1 被加数
     * @param v2 加数
     * @return 两个参数的和
     */
    public static Double add(double v1,double v2,Integer scale){
        if(scale<0){
            throw new IllegalArgumentException("The scale must be a positive integer or zero");
        }
        BigDecimal b1 = new BigDecimal(Double.toString(v1));
        BigDecimal b2 = new BigDecimal(Double.toString(v2));
        return b1.add(b2).setScale(scale,BigDecimal.ROUND_HALF_UP).doubleValue();

    }


    /**
     * 提供精确的减法运算。
     * @param v1 被减数
     * @param v2 减数
     * @return 两个参数的差
     */
    public static Double sub(double v1,double v2){

        return sub(v1, v2,DEF_DIV_SCALE);
    }
    /**
     * 提供精确的减法运算。
     * @param v1 被减数
     * @param v2 减数
     * @return 两个参数的差
     */
    public static Double sub(double v1,double v2,int scale){
        if(scale<0){
            throw new IllegalArgumentException("The scale must be a positive integer or zero");
        }
        BigDecimal b1 = new BigDecimal(Double.toString(v1));
        BigDecimal b2 = new BigDecimal(Double.toString(v2));
        return b1.subtract(b2).setScale(scale,BigDecimal.ROUND_HALF_UP).doubleValue();
    }



    /**
     * 提供精确的乘法运算。
     * @param v1 被乘数
     * @param v2 乘数
     * @return 两个参数的积
     */
    public static Double mul(double v1,double v2){

        return mul( v1, v2,DEF_DIV_SCALE );
    }

    /**
     * 提供精确的乘法运算。
     * @param v1 被乘数
     * @param v2 乘数
     * @param scale 表示表示需要精确到小数点以后几位。
     * @return 两个参数的积
     */
    public static Double mul(double v1,double v2, int scale){
        if(scale<0){
            throw new IllegalArgumentException("The scale must be a positive integer or zero");
        }
        BigDecimal b1 = new BigDecimal(Double.toString(v1));
        BigDecimal b2 = new BigDecimal(Double.toString(v2));
        return b1.multiply(b2).setScale(scale,BigDecimal.ROUND_HALF_UP).doubleValue();
    }
    /**
     * 提供（相对）精确的除法运算，当发生除不尽的情况时，精确到
     * 小数点以后10位，以后的数字四舍五入。
     * @param v1 被除数
     * @param v2 除数
     * @return 两个参数的商
     */
    public static Double div(double v1,double v2){
        return div(v1,v2,DEF_DIV_SCALE);
    }
    /**
     * 提供（相对）精确的除法运算。当发生除不尽的情况时，由scale参数指
     * 定精度，以后的数字四舍五入。
     * @param v1 被除数
     * @param v2 除数
     * @param scale 表示表示需要精确到小数点以后几位。(必须有否则会出现未知错误)
     * @return 两个参数的商
     */
    public static Double div(double v1,double v2,int scale){
        if(scale<0){
            throw new IllegalArgumentException("The scale must be a positive integer or zero");
        }
        BigDecimal b1 = new BigDecimal(Double.toString(v1));
        BigDecimal b2 = new BigDecimal(Double.toString(v2));
        return b1.divide(b2,scale,BigDecimal.ROUND_HALF_UP).doubleValue();
    }
    /**
     * 提供精确的小数位四舍五入处理。
     * @param v 需要四舍五入的数字
     * @param scale 小数点后保留几位  (必须有否则会出现未知错误)
     * @return 四舍五入后的结果
     */
    public static Double round(double v,int scale){
        if(scale<0){
            throw new IllegalArgumentException("The scale must be a positive integer or zero");
        }
        BigDecimal b = new BigDecimal(Double.toString(v));
        BigDecimal one = new BigDecimal("1");
        return b.divide(one,scale,BigDecimal.ROUND_HALF_UP).doubleValue();
    }


    /**
     * toString() – 在必要的时候使用科学计数法 (自动适配)
     *
     */
    public static String   turn(double v){
        return  new BigDecimal(v).toString();
    }
    /**
     * 将科学计数法 转为Spring普通数字  toPlainString() – 不使用任何科学计数法。
     * @param v
     */
    public static String   turnPlain(double v){
        return  new BigDecimal(v).toPlainString();
    }

}
